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pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
http://webapp.etsi.org/key/queryform. asp . 
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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3 rd Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32. 121 : Advanced Alarm Management Integration Reference Point (IRP): Requirements. 

32.122: Advanced Alarm Management Integration Reference Point (IRP): Information Service (IS). 

32.123: Advanced Alarm Management Integration Reference Point (IRP): Common Object Request 

Broker Architecture (CORBA) Solution Set. 

The Itf-N interface is built up by a number of IRPs and a related Name Convention, which realise the functional 
capabilities over this interface. The basic structure of the IRPs is defined in 3GPP TS 32.150 [1]. 

A single network fault may generate a large number of alarms over space and time. In a large and complex network, 
simultaneous network faults may occur, causing the network operator to be flooded with high volume of alarms. The 
high volume of alarms, typically the one received by an IRPManager via the getAlarmList or alarm notifications of 
Alarm IRP specification, greatly inhibits the operator ability to quickly identify and locate the responsible network 
faults. Advanced AlarmManagement IRP is intended to provide methods to improve this situation. 
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Scope 



The purpose of Advanced Alarm Management (AAM) IRP is to define an interface through which an IRPManager can 
categorize alarm notifications. 

The present document is the AAM IRP CORB A Solution Set, whose semantics are specified in AAM IRP Information 
Service (3GPP TS 32.122 [3]). 

This Solution Set specification is related to TS 32.122 v8.0.0. 



2 References 

The following documents contain provisions that, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document 
(including a GSM document), a non-specific reference implicitly refers to the latest version of that document in 
the same Release as the present document. 

[1] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[2] 3GPP TS 32.121: "Telecommunication management; Advanced Alarm Mangement (AAM) 

Integration Reference Point (IRP): Requirements". 

[3] 3GPP TS 32.122: "Telecommunication management; Advanced Alarm Mangement (AAM) 

Integrations Reference Point (IRP); Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

IRP: See 3GPP TS 32.150 [1]. 

IRPAgent: See 3GPP TS 32.150 [1]. 

IRPManager: See 3GPP TS 32.150 [1]. 

Alike Alarm: Two alarms are considered alike, if the corresponding alarm notifications are issued by the same object 
instance with the same alarmType, same perceivedSe verity, same probableCause and same specificProblem (if present). 

Lower Edge of Time Window: The point in time which determines the begin of a time span. 

Upper Edge of Time Window: The point in time which determines the end of a time span. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 
AAM Advanced Alarm Management 
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AAMRule Advanced Alarm Management Rule 

CM Configuration Management 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

Itf-N Interface N 

MIB Management Information Base 

NE Network Element 



4 Architectural features 

The overall architectural feature of Advanced Alarm Mangement IRP is specified in 3GPP TS 32.122 [3]. 



5 Mapping 

5.1 General mappings 

Not applicable. 

5.2 Operation and notification mapping 

The AAM IS (3GPP TS 32.122 [3]) defines semantics of operations visible across the Itf-N. 

Table 5.2-1 indicates mapping of these operations and notifications to their equivalents defined in this CORBA SS. 

Table 5.2-1 : Mapping from IS Operation to SS equivalents 



IS Operation / Notification 
(3GPPTS 32.122) 


SS Method 


Qualifier 


activateAAMRule 


activate aam rule 


M 


getAAMRules 


get aam rules 


M 


deactivate AAM Rule 


deactivate aam rule 


M 



5.3 Operation parameter mapping 



The AAM IS (3GPP TS 32.122 [3]) defines semantics of parameters carried in operations across the Itf-N. 

The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this 

CORBA SS. 

Table 5.3-1 : Mapping from IS activateaamrule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam_rule_type 


AAMConstDefs::AAMRuleType 


M 


aam_rule_parameter_list 


AAMConstDefs:: 
AAMRuleParameterList 


M 


filter 


AdvancedAlarmManegementConstDefs::FilterType 


M 


status 


Exceptions: 

AAMConstDefs::ActivateAAMRule, 

AAMConstDefs::AAMRuleAlreadyActive, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 


aam_rule_identifier 


AAMConstDefs:: AAMRuleldentifier 


M 
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Table 5.3-2: Mapping from IS get_advanced_alarm_management_rules parameters to SS 

equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam rule list 


AAMConstDefs::AAMRulel_ist 


M 


status 


Exceptions: 

AAMConstDefs::GetAAMRules, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 



Table 5.3-3: Mapping from IS deactivateaamrule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam rule identifier 


AAMConstDefs::AAMRuleldentifier 


M 


status 


Exceptions: 

AAMConstDefs::DeactivateAAMRule, 

AAMConstDefs::SpecifiedRuleNotExisting, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 



5.4 Notification parameter mapping 

None. 
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Annex A (normative): 
I DL specifications 

A.1 IDL specification (file name "AAMConstDefs.icN") 

// File: AAMConstDef s . idl 
#ifndef _AAM_CONST_DEFS_IDL_ 
#define _AAM_CONST_DEFS_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AAMConstDef s */ 
module AAMConstDefs 

{ 

/* definition of types used in several operations for Advanced Alarm Management */ 

enum AAMRuleType { 
THRESHOLD_RULE, 
TRANSIENT_RULE, 
TOGGLE_RULE , 
VENDOR_SPECIFIC_RULE 

} ; 

enum Status {SUCCESS, FAILURE, AAM_RULE_ALREADY_ACTIVE }; 
typedef string AAMRuleldentif ier; 

/* types used in operation activateAAMRule and */ 
/* types used in operation getAAMRules */ 

typedef string FilterType; 

typedef string TimeSpan; 

typedef string AlarmOccurenceThreshold; 

typedef string SlidingTimeWindow; 

struct AAMRuleParameterListForTransientRule 

{ 

TimeSpan time_span; 



struct AAMRuleParameterListForThresholdRule 

{ 

AlarmOccurenceThreshold alarm_occurence_threshold ; 
SlidingTimeWindow sliding_time_window; 



struct AAMRuleParameterListForToggleRule 

{ 

AlarmOccurenceThreshold alarm_occurence_threshold ; 
SlidingTimeWindow sliding_time_window_toggling_started; 
SlidingTimeWindow sliding_time_window_toggling_settled; 



typedef string VendorSpecif icParameterldentif ier; 
typedef string VendorSpecif icParameterValue; 

struct VendorSpecif icParameter 
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VendorSpecif icParameter Identifier vendor_specif ic_parameter_identif ier; 
VendorSpecif icParameterValue vendor_specif ic_parameter_value; 

} ; 

typedef sequence < VendorSpecif icParameter> AAMRuleParameterListForVendorSpecif icRule; 

/* The AAMRuleParameterList may contain a list of */ 

/* AAMParameters with different content depending on the */ 
/* AAMRuleType. */ 

union AAMRuleParameterList switch (AAMRuleType) 

{ 

case THRESHOLD_RULE : AAMRuleParameterListForTransientRule 

aam_rule_parameter_list_for_transient_rule; 
case TRANSIENT_RULE: AAMRuleParameterListForThresholdRule 

aam_rule_parameter_list_for_threshold_rule; 
case TOGGLE_RULE: AAMRuleParameterListForToggleRule 

aam_rule_parameter_list_for_toggle_rule; 
case VENDOR_SPECIFIC_RULE : AAMRuleParameterListForVendorSpecif icRule 

aam_rule_parameter_list_for_vendor_specif icRule; 



struct AAMRule 

{ 

AAMRule I dent if ier aam_rule_identif ier; 
AAMRuleType aam_rule_type ; 

AAMRuleParameterList aam_rule_parameter_list ; 
FilterType filter; 



typedef sequence <AAMRule> AAMRuleList; 



/* types used in operation deactivateAAMRule only */ 
/* none */ 



#endif // AAM CONST DEFS IDL 



A.2 IDL specification (file name "AAMSystem.icH") 

//File: AAMSystem. idl 
#ifndef _AAM_SYSTEM_IDL_ 
#define _AAM_SYSTEM_IDL_ 

#include <AAMConstDef s . idl> 

#include <GenericIRPManagementSystem. idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AAMSystem */ 

module AdvancedAlarmManagementIRPOperation_l 
{ 

/* 

If the system fails to complete an operation, then it can provide a reason 
to qualify the exception. The semantics carried in this reason are outside 
the scope of the present document . 
*/ 

exception Activate AAMRule { string reason; } ; 
exception AAMRuleAlreadyActive { string reason; } ; 
exception GetAAMRules { string reason; } ; 
exception DeactivateAAMRule { string reason; } ; 
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exception Specif iedRuleNotExisting { string reason; } ; 
interface AdvancedAlarmManagement 

{ 

AAMConstDef s : : Status activate_aam_rule 

/* for the purpose of this operation see 3GPP TS 32.322 */ 
( 
in AAMConstDef s : :AAMRuleType 

aam_rule_type , 
in AAMConstDef s: : AAMRuleParameterList 

aam_rule_parameter_list , 
in AAMConstDef s : :FilterType filter, 
out AAMConstDef s: : AAMRuleldentif ier 

aam_rule_identif ier 

) 



( 

ActivateAAMRule, 
AAMRuleAlreadyActive, 
Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 



ParameterNot Supported, 
InvalidParameter, 
ValueNot Supported, 
OperationNot Supported 



AAMConstDef s : : Status get_aam_rules 

/* for the purpose of this operation see 3GPP TS 32.322 */ 



out 



AAMConstDefs: 
aam rule list 



AAMRuleList 



( 

GetAAMRules, 

Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 
) ; 



ParameterNot Supported, 
InvalidParameter, 
ValueNot Supported, 
OperationNot Supported 



AAMConstDefs: : Status deactivate_aam_rule 

/* for the purpose of this operation see 3GPP TS 32.322 */ 

( 

in AAMConstDef s : : AAMRuleldent if ier 
aam rule identifier 



( 

DeactivateAAMRule, 
Specif iedRuleNotExisting, 
Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 
Generic IRPManagement System 



ParameterNot Supported, 
InvalidParameter, 
ValueNot Supported, 
OperationNot Supported 



) ; 



#endif // AAM SYSTEM IDL 
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Annex B (informative): 
Change history 
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